
    <!DOCTYPE html>
    <html lang="zh-CN">
    <head>
      <meta charset="UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1.0">
      <title>接口幂等性 - 学习卡片</title>
      <style>
        body { font-family: sans-serif; background-color: #f0f8ff; color: #333; display: flex; flex-direction: column; align-items: center; padding: 50px 20px; }
        .header h1 { font-size: 32px; }
        .grid-container { display: grid; grid-template-columns: repeat(3, 1fr); gap: 28px; width: 100%; max-width: 1200px; }
        .card-container { perspective: 1200px; cursor: pointer; height: 250px; }
        .card { width: 100%; height: 100%; position: relative; transform-style: preserve-3d; transition: transform 0.7s; border-radius: 16px; box-shadow: 0 4px 16px rgba(0,0,0,0.08); }
        .card-container.flipped .card { transform: rotateY(180deg); }
        .card-face { position: absolute; width: 100%; height: 100%; backface-visibility: hidden; display: flex; flex-direction: column; box-sizing: border-box; border-radius: 16px; background-color: #fff; padding: 24px; }
        .card-back { background-color: #f0fff4; transform: rotateY(180deg); justify-content: space-between; }
        .card-category { font-size: 14px; color: #0052d9; margin-bottom: 8px; font-weight: 500; }
        .card-question { font-size: 20px; font-weight: 500; flex-grow: 1; display: flex; align-items: center; justify-content: center; text-align: center; }
        .card-answer-wrapper { flex-grow: 1; overflow-y: auto; }
        .card-answer { font-size: 15px; line-height: 1.7; }
        .card-footer { font-size: 13px; color: #8a919f; border-top: 1px solid #f0f0f0; padding-top: 16px; margin-top: 16px; }
        .card-source { font-size: 13px; color: #8a919f; border-top: 1px solid #f0f0f0; padding-top: 12px; margin-top: 12px; }
      </style>
    </head>
    <body>
      <div class="header">
        <h1>接口幂等性 - 学习卡片</h1>
      </div>
      <div class="grid-container">
        
    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">理论</div>
          <div class="card-question">什么是接口幂等性？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">理论</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">用户对于同一操作发起的一次请求或者多次请求的结果是一致的，不会因为多次点击而产生了副作用。</div>
          </div>
          <div class="card-source">来源: 幂等性概念</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">为什么像 `update good set stock = stock+10 where id = 10` 这样的条件更新操作不具备幂等性？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">因为每次执行该操作，库存数量都会在之前的基础上加10，多次执行会产生累加的副作用，导致结果不一致，所以不具备幂等性。</div>
          </div>
          <div class="card-source">来源: 修改</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">机制</div>
          <div class="card-question">简述使用Token机制实现接口幂等性的核心处理流程。</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">机制</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">1. 客户端在提交数据前先向服务器申请一个有时效性的token。 2. 服务端在处理提交请求时，会校验这个token，校验通过后立即删除该token，然后执行业务逻辑。这样一来，携带同一个token的重复请求就会因为token已被删除而校验失败。</div>
          </div>
          <div class="card-source">来源: 接口幂等性解决方案 > Token机制</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">在使用Token机制时，为什么推荐直接使用删除操作来校验token，而不是“select+delete”？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">因为“select+delete”不是原子操作，在并发场景下可能会出现问题（例如两个请求同时查询到token有效，然后都去执行删除和后续业务）。而直接使用原子性的删除操作（如Redis的DEL命令），通过判断删除是否成功来校验token，可以有效避免并发问题。</div>
          </div>
          <div class="card-source">来源: 接口幂等性解决方案 > Token机制</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">模式</div>
          <div class="card-question">如何利用CAS（比较并交换）思想来保证接口幂等性？请举例说明。</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">模式</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">通过在更新数据时携带一个前置状态作为条件，只有当数据的当前状态与预期一致时才执行更新。例如，更新订单状态的SQL：`update order set status = 1 where status = 0 and orderId = “201251487987”`，只有当订单状态为0时才能成功更新为1，从而防止重复执行。</div>
          </div>
          <div class="card-source">来源: 接口幂等性解决方案 > CAS 保证接口幂等性</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">模式</div>
          <div class="card-question">乐观锁是如何通过版本号（version）来实现幂等性的？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">模式</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">在数据表中增加一个version字段。更新数据时，将当前版本号作为更新条件，并在更新成功后将版本号加一。例如：`update t_goods set count = count -1 , version = version + 1 where good_id=2 and version = 1`。如果一个请求已经执行成功，版本号会改变，后续的重复请求会因为版本号不匹配而更新失败。</div>
          </div>
          <div class="card-source">来源: 接口幂等性解决方案 > 乐观锁实现幂等</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">特性</div>
          <div class="card-question">根据文档，哪些类型的数据库操作通常被认为是天然具有幂等性的？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">特性</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">查询操作（select）、基于唯一主键的删除操作（如 `delete from product where id = 3`）以及基于唯一主键的更新固定值的操作（如 `update good set stock= 586 where id = 10`）都天然具有幂等性，因为无论执行多少次，对数据最终状态的影响都是相同的。</div>
          </div>
          <div class="card-source">来源: 删除, 修改, 查询</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">机制</div>
          <div class="card-question">什么是“防重表”方案？它是如何防止重复操作的？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">机制</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">“防重表”方案是指建立一张专门的表来记录已经处理过的请求的唯一标识（如业务主键或订单号）。每次执行业务操作前，先尝试将该唯一标识插入防重表，如果插入成功则执行业务逻辑；如果因为主键冲突而插入失败，则说明是重复请求，不执行业务逻辑。</div>
          </div>
          <div class="card-source">来源: 接口幂等性解决方案 > 防重表</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">对于并发度不高的系统，文档中提到的最简单的幂等性支持方法是什么？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">对于并发不高的后台系统或一些任务，最简单的方法是采用 “select + insert” 模式。即在执行业务处理前，先通过查询关键数据来判断该操作是否已经执行过，如果未执行，再进行业务处理。</div>
          </div>
          <div class="card-source">来源: 接口幂等性解决方案 > select + insert</div>
        </div>
      </div>
    </div>

      </div>
    </body>
    </html>
